Project ABC—Development Case

This is an example of what a development case may look like. There is no point in restating information already in the process. What you have to describe are the deviations from the process. You may put together a Development Case that contains a small description of the process. However, the problem with that kind of document is that they tend to grow forever, until they're the size of the process handbook!

This example is intended to give you an idea about how a development case would look for a small project, let's say a commercial information system.

For more information about the Development Case, its contents, and outline, see Artifact: Development Case.

Topics

Introduction (to top)

Revision History (to top)

Date

Version

Description

Author

01/01/2000

1.0 - Tom Smith

 

Purpose (to top)

The purpose of the document is to describe the development process for the project ABC.

Definitions, Acronyms, and Abbreviations (to top)

Not applicable.

References (to top)

Not applicable.

Overview of the Development Case (to top)

Lifecycle Model (to top)

See the section titled "Project Plan" in the project's Software Development Plan.

Core Workflows (to top)

The development-case example presented here takes you through all nine core workflows: Business Modeling, Requirements, Analysis & Design, Implementation, Test, Deployment, Configuration & Change Management, Project Management, and Environment.

Core Workflow Configuration  (to top)

The purpose of this section is to explain how the core workflow configuration works. This includes the purpose of the different tables and sections that describe each core workflow in the section titled "Core Workflows".

Section: "Workflow"

This section details any changes made to the structure of the workflow itself. Typical changes include the addition of activities to describe company-specific ways of working or the removal of activities from the workflow.

Section: "Artifacts"

The section describes, in a table, how the artifact will be used. Additional 'local' artifacts can be added to the table as needed. 

Artifacts How to use Review Details Tools used Templates/
Examples
Incep Elab Const Trans
               

 

Explanation of the table

Column Name Purpose Contents/Comments
Artifacts To name of the artifact  A reference to the artifact in the Rational Unified Process or to a local artifact definition that's held as part of the development case. 
How to use To qualify how the artifact is used across the life cycle For each phase, decide on: 
  • Must haves
  • Should haves
  • Could haves
  • Won't haves

These are defined in the Guidelines: Classifying Artifacts.  

Review Details To define the review level and review procedures  applied to the artifact.  Decide on the review level: 
  • Formal-External
  • Formal-Internal
  • Informal
  • None

For details, see Guidelines: Review Levels.

Also add a reference to the definition and detail of the relevant review procedures. The reference could point to either the Rational Unified Process or to the section titled "Review Procedure" in the development case. More specific review procedures are defined in the workflow's "Additional Review Procedures" sub-section.

Tools used To define the tool or tools used to produce the artifact. References to the details of the tools used to develop and maintain the artifact.
Templates/Examples To provide the templates to be used and examples of artifacts that use the templates. References to templates and examples. This could refer to either the templates and examples in the Rational Unified Process or local templates and examples. This column may also contain references to actual artifacts that provide additional help to project members.
Section: "Notes on Artifacts"

This section has three main purposes: 

  • It contains a list all artifacts you Won't use and the motives behind your decision not to use them. 
  • It contains a reference to the project's Configuration Management (CM) Plan, which describes the configuration management strategy used when working on these artifacts. The CM Plan allows developers to answer questions such as: 
    • When do I release my artifact? 
    • Where do I put my newly created or modified artifact?
    • Where do I find existing artifacts for the project?
  • If the development case is an organization-level development case, this is where you add notes on what each project needs to consider when they decide what to do with the artifact. Use the predefined table below as a starting point. 
Artifacts How to Use Reason
 
 
 
Section: "Reports"

This section lists the reports to be used and additional 'local' reports can be added to the table as needed.

Reports How to use Templates/Examples Tools Used
   
 
 
Section: "Notes on the Reports"

This section has two main purposes. First, it lists all reports that the project has decided it Won't use, and the motives behind its decision not to use them. Secondly, if the development case is a an organization-level use case, this is where to add notes on what each project needs to consider when they decide what to do with the report.

Section: "Additional Review Procedures"

This section captures any additional review procedures required for the artifacts used in the workflow. These supplement the general review procedures described in the "Overview" section of the Development Case.

Section: "Other Issues"

This section captures any outstanding issues with the workflow's configuration. This section can be used as an Issues List while building the development case.

Artifact Classification (to top)

An artifact is a deliverable of the process. It is often developed within one core workflow, although there are exceptions. The artifacts are organized in the workflow where it's created. To describe how an artifact will be used, consider the following classification scheme and see Guidelines: Classifying Artifacts for details:  

  • Must

  • Should

  • Could

  • Won't

Review Procedures (to top)

The project uses the following review levels: 

  • Formal-External
  • Formal-Internal
  • Informal
  • None

For details, see Guidelines: Review Levels.

Sample Iteration Plans  (to top)

Inception Phase
Elaboration Phase

To be defined later in the project.

Construction Phase

To be defined later in the project.

Transition Phase

To be defined later in the project.

Core Workflows (to top)

Business Modeling (to top)

Workflow

Follow the Domain Modeling workflow detail only. See Business Modeling: Overview.

Artifacts
Artifacts How to use Review Details Tools used Templates/
Examples
Incep Elab Const Trans
Business Entity

Must

Could

Could

Could

Formal-External

Rose

 
Business Glossary

Must

Could

Could

Could

Formal-External

Rose

 
Business Object Model

Must

Could

Could

Could

Formal-External

Rose

 

Target-Organization Assessment

Must

Could

Could

Could

Formal-External

Word

 
Notes on the Artifacts

See the project's Configuration Management Plan for information on how the artifacts are 
configuration-managed.

The project decided to only perform domain modeling, which means that the following artifacts will not be developed: Business Actor, Business Architecture Document, Business Rules, Business Use Case, Business Use-Case Model, Business Vision, Business Worker, Organization Unit, and Supplementary Business Specification.

Reports
Reports How to use Templates/Examples Tools Used
Business Entity Could

 

Word

Business Object Model Survey Could

SoDA
Word

Requirements (to top)

Workflow

No changes. For details see the Requirements Overview.

Artifacts
Artifacts How to use Review Details Tools used Templates/
Examples
Incep Elab Const Trans
Actor

Must

Must

Must

Must

Informal

 
Boundary Class

Won't

Must

Could

Could

Informal

 
Glossary Must Must Must Must Formal-External    
Requirements Attributes Must Must Must Must Formal-Internal    
Requirements Management Plan Must Must Must Must Formal-
Internal
   
Stakeholder Requests Must Must Must Must Formal-External    
Software Requirements Specification Must Must Must Must Formal-External    
Supplementary Specification Must Must Must Must Formal-External    
Use Case Must Must Must Must Formal-External    
Use-Case Model Must Must Must Must Formal-External    
Use-Case Package Must Must Must Must Informal    
Use-Case Storyboard Won't Must Could Could Informal    
User-Interface Prototype Won't Must Could Could Formal-External    
Vision Must Must Must Must Formal-External    
Notes on the Artifacts

See the project's Configuration Management Plan for information about how the artifacts are 
configuration-managed.

Reports
Reports How to Use Templates/Examples Tools Used
Actor Could    
Use-Case Could

 

    
Use-Case Model Survey Could

 

Use-Case Storyboard Could    

Analysis & Design (to top)

Workflow

A real-time application is not being developed, therefore the Capsule Designer worker and the activity Capsule Design are excluded. For details on the workflow, see the Analysis & Design Overview

Artifacts
Artifacts How to use Review Details Tools used Templates/
Examples
Incep Elab Const Trans
Data Model Won't Could Could Could Informal Rose  
Deployment Model Could Must Must Must Formal-
Internal
Rose  
Design Class Could Must Must Must Informal Rose  
Design Model Could Must Must Must Formal-
Internal
Rose  
Design Package Could Must Must Must Formal-
Internal
Rose  
Design Subsystem Could Must Must Must Formal-
Internal
Rose  
Interface Could Must Must Must Formal-
Internal
Rose  
Reference Architecture Could Must Must Must Formal-
Internal
Rose  
Software Architecture Document (SAD) Could Must Must Must Formal-
External
SoDA
Word
 
Use-Case Realization Could Must Must Must Informal Rose  
Notes on the Artifacts

The project is not developing a real-time product, which means that the following artifacts will not developed: Capsule, Event, Protocol, and Signal.

The project decided not to keep an analysis model, which means that the following artifacts will not be developed: Analysis Class and Analysis Model. 

Reports
Reports How to Use Templates/Examples Tools Used
Class Could   SoDA
Word
Design-Model Survey Could   SoDA
Word
Design Package/Subsystem Could   SoDA
Word
Use-Case Realization Could   SoDA
Word

Implementation (to top)

Workflow

No changes in the workflow. For details see the Implementation Overview.

Artifacts
Artifacts How to use Review Details Tools used Templates/
Examples
Incep Elab Const Trans
Build Could Must Must Must Informal Visual Basic  
Component Could Must Must Must Informal

Code reviews

Visual Basic  
Implementation Model

Could

Must

Must

Must

Informal

Visual Basic

 
Implementation Subsystem

Could

Must

Must

Must

Formal-
Internal

Visual Basic

 
Integration Build Plan Could Must Must Must Formal-
Internal
Word  
Additional Review Procedures

Informal code reviews are performed. 

Testing (to top)

Workflow

No formal performance test is done, otherwise the workflow is followed unchanged. For details on the process, see the Test: Overview.

Artifacts
Artifacts How to use Review Details Tools used Templates/
Examples
Incep Elab Const Trans
Test Case

Won't

Could

Must

Must

Informal

Word

 
Test Class

Won't

Could

Must

Must

Informal

Rose

 
Test Components Won't Could Must Must Informal Visual Basic  
Test Evaluation Summary Won't Could Must Must Informal Word  
Test Model Won't Could Must Must Informal Rose  
Test Package Won't Could Must Must Informal Rose  
Test Plan Could Could Must Must Informal Word  
Test Procedure Won't Could Must Must Informal Word  
Test Results Won't Could Must Must Informal Word  
Test Script Won't Could Must Must Informal TestStudio  
Test Subsystem Won't Could Must Must Informal Rose  
Notes on the Artifacts

No Workload Analysis Document is developed.

Additional Review Procedures
  • Test cases—informally approved by the system testers.
  • The system testers decide if the test criteria for an iteration is fulfilled.
  • The customer approves the final iteration.

Deployment (to top)

Workflow

A previously existing deployment workflow was adapted to use the artifacts suggested in the Rational Unified Process. An exception is the Course Material artifact, which is excluded because no formal training is produced for our product.

Artifacts
Artifacts How to use Review Details Tools used Templates/
Examples
Incep Elab Const Trans
Bill of Materials

Won't

Won't

Could

Must

Formal-
Internal

Word

 
Deployment Plan

Won't

Could

Must

Must

Informal

Word

 
Deployment Unit

Won't

Could

Could

Must

Informal

Word

 
Support Material

Won't

Could

Could

Must

Informal

Word

 
Installation Artifacts Won't Could Could Must Informal Word  
Product Won't Could Could Must Formal-
External
   
Product Artwork Won't Could Could Must Informal Word  
Release Notes Won't Could Could Must Formal-
Internal
Word  
Notes on the Artifacts

No Training Materials are developed because the product does not require formal training. 

Reports
Reports How to Use Templates/Examples Tools Used
   
 
 

Configuration & Change Management (to top)

Workflow

No changes in the workflow. For details on the process, see the Configuration & Change Management: Overview.

Artifacts
Artifacts How to use Review Details Tools used Templates/
Examples
Incep Elab Const Trans
Change Request

Won't

Could

Must Must Informal

ClearQuest

 
Configuration Audit Findings

Won't

Could

Must

Must

Informal

Word

 
Configuration Management Plan Won't Must Must Must Informal Word  
Project Repository Won't Could Must Must None ClearCase  
Workspace Won't Could Must Must None ClearCase  

Project Management (to top)

Workflow

No changes to the workflow. For details, see Project Management: Overview.

Artifacts
Artifacts How to use Review Details Tools used Templates/
Examples
Incep Elab Const Trans
Business Case

Must

Must

Could

Could

Formal-
External

Word

 
Iteration Assessment

Must

Must

Must

Must

Informal

Word

 
Iteration Plan Could Must Must Must Informal Word  
Measurement Plan Could Could Could Could Informal Word  
Problem Resolution Plan Must Must Must Must Informal Word  
Product Acceptance Plan Could Must Must Must Informal Word  
Project Measurements Could Could Must Must Informal Word  
Quality Assurance Plan Could Could Could Could Informal Word  
Review Record Must Must Must Must Informal Word  
Risk List Must Must Must Must Formal-
Internal
Word  
Risk Management Plan Could Must Must Must Informal Word  
Software Development Plan (SDP) Won't Could Must Must Formal-
Internal
Word
Project
 
Status Assessment Could Must Must Must Informal Word  
Notes on the Artifacts

The artifact Work Order won't be used. 

Environment (to top)

Workflow

No changes in the workflow. For details on the process, see the Environment: Overview.

Artifacts
Artifacts How to use Review Details Tools used Templates/
Examples
Incep Elab Const Trans
Business Modeling Guidelines

Must

Could

Could

Could

Informal

Word

 
Design Guidelines

Won't

Must

Must

Must

Informal

Word

 
Development Case Must Must Must Must Informal FrontPage  
Development Infrastructure Must Must Must Must Informal Word  
Development-Organization Assessment Must Won't Won't Won't Informal Word  
Manual Styleguide Won't Could Must Must Informal Word  
Project-Specific Templates Must Must Must Must Informal Word  
Programming Guidelines Won't Must Must Must Informal Word  
Test Guidelines Won't Must Must Must Informal Word  
Tools Must Must Must Must Informal Word to document  
Tool Guidelines Won't Could Must Must Informal Word  
Use-Case Modeling Guidelines Must Must Must Must Informal Word  
User-Interface Guidelines Won't Must Must Must Informal Word  

Workers (to top)

Not applicable.

Copyright  ⌐ 1987 - 2000 Rational Software Corporation

Rational Unified Process